home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 020a / dvpt20.zip / VDFE.HLP < prev    next >
Text File  |  1991-12-12  |  15KB  |  301 lines
  1.  *   *   *   *   *   *   *   VDFE v2.0 Help File   *   *   *   *   *   *   *
  2.  
  3.          ┌──────────────────────────────────────────────────────────┐
  4.          │ »»»»»»»»»»»»»»»»»»  NON-MENU ACTIONS ««««««««««««««««««« │
  5.          ├─────────────────────────────────────┬────────────────────┤
  6.          │ Action                  Key         │ Action         Key │
  7.          ├─────────────────────────────────────┼────────────────────┤
  8.          │ Selected a Value                │ Redraw Screen  F9  │
  9.          │ Selected Value + 1      Shift+     │ Activate Menu  F10 │
  10.          │ Selected Value + 100    Shift+PgDn  │                    │
  11.          │ Selected Value + 10000  Shift+End   │                    │
  12.          │ Selected Value - 1      Shift+     │                    │
  13.          │ Selected Value - 100    Shift+PgUp  │                    │
  14.          │ Selected Value - 10000  Shift+Home  │                    │
  15.          └─────────────────────────────────────┴────────────────────┘
  16.  ┌──────────────────────────────────────────────────────────────────────────┐
  17.  │ »»»»»»»»»»»»»»»»»»»»»»»»»»»»  MENU ACTIONS ««««««««««««««««««««««««««««« │
  18.  ├────────────────────────────┬─────────────────────────────────────────────┤
  19.  │ Action             Key     │ Action                         Key          │
  20.  ├────────────────────────────┼─────────────────────────────────────────────┤
  21.  │ Load Index File    Alt+I   │ Play the Block                 Enter        │
  22.  │ Load Data File     Alt+D   │ Merge Current Block with Next  M            │
  23.  │ Change File Names  Alt+N   │ Split Current Block            S            │
  24.  │ Save Index File    Ctrl+I  │ Cut Block to Clipboard         Del          │
  25.  │ Save Data File     Ctrl+D  │ Paste from Clipboard           Insert       │
  26.  │ Save Both          Ctrl+S  │ Copy Block to Clipboard        Shift+Insert │
  27.  │ Create Index       I       │ Delete the Block               Shift+Del    │
  28.  │ Pack Data          Ctrl+P  │ Write Clipboard to File        W            │
  29.  │ Help               F1      │ Read File into Clipboard       R            │
  30.  │ Exit               Esc     │ Record into Clipboard          F3           │
  31.  │                            │ Play Clipboard Contents        F4           │
  32.  │                            │ Select COM Port                F2           │
  33.  └────────────────────────────┴─────────────────────────────────────────────┘
  34.  
  35.  ══════════════════════════════╡ Introduction ╞══════════════════════════════
  36.  
  37.  VDFE is designed to work with pairs of files, one containing the actual
  38.  digitized voice data and the other providing an index into the words,
  39.  phrases, and sounds stored in the data file. This allows a reasonable level
  40.  of programming flexibility, especially for systems using large amounts of
  41.  voice data. VDFE works only with data files in their uncompressed form.
  42.  
  43.  Data files are unlimited in length. Index files may contain at most 4096
  44.  entries. An index file consists only of a number of index entries packed
  45.  together. Each entry is 8 bytes long, so the file length will be 8 times
  46.  the number of entries. One entry in an index file is formatted as follows:
  47.  
  48.         Bytes 0 - 3:     Offset from beginning of data file in bytes.
  49.         Bytes 4 - 7:     Length of sound in bytes.
  50.  
  51.  Each of the two parts of the entry is a "long" (4-byte) integer, stored
  52.  in "low byte first" order.
  53.  
  54.  In this document, a "block" refers to a segment of a voice data file as
  55.  referenced by an entry in the corresponding index file. The length of a
  56.  block may range from 1 byte to the length of the entire data file. Note,
  57.  however, that VDFE requires blocks to be sequential and non-overlapping.
  58.  Gaps may exist, but no voice data byte may be a part of two blocks.
  59.  
  60.  ═════════════════════╡ Explanation of Screen Contents ╞═════════════════════
  61.  
  62.  Menu Bar:
  63.    Works in the conventional way. Activate by pressing F10. The mouse is not
  64.    supported in this version. Use of the menu bar is optional, since all
  65.    commands are accessible through direct keystrokes.
  66.  
  67.  Blk # (Block number):
  68.    Shows a sequential reference number for each index entry.
  69.  
  70.  Start:
  71.    Shows the starting byte number within the data file for each block. Can be
  72.    changed from the keyboard.
  73.  
  74.  Stop:
  75.    Shows the ending byte number within the data file for each block. Can be
  76.    changed from the keyboard. The number actually saved in the index file for
  77.    each block is <Stop> - <Start>.
  78.  
  79.  Block count:
  80.    This is the total number of blocks currently defined for the index file.
  81.  
  82.  Data file size:
  83.    The total number of bytes currently in the data file.
  84.  
  85.  Buffer size:
  86.    This is the number of bytes in the RAM buffer. This number has no effect
  87.    on the size of the data file that may be edited, or the size of files that
  88.    may be read and written through the clipboard. It affects only actual
  89.    recording and playback. It is the maximum size allowed for any block to be
  90.    played through the speaker, although larger blocks may be otherwise
  91.    manipulated. It is also the maximum number of bytes that can be
  92.    continuously recorded into the clipboard.
  93.  
  94.  Digitizer port:
  95.    This is the COM port number to which the voice digitizer hardware is
  96.    attached. It can be set with the F2 key. Used for recording only.
  97.  
  98.  Index file:
  99.    The name of the current index file. Change by pressing Alt+N. The current
  100.    index will be written to this file name by Ctrl+I or Ctrl+S.
  101.  
  102.  Data file:
  103.    The name of the current data file. Change by pressing Alt+N. The current
  104.    data will be written to this file name by Ctrl+D or Ctrl+S.
  105.  
  106.  Instruction area:
  107.    Always displays a very brief set of operating instructions.
  108.  
  109.  ══════════════════╡ Descriptions of Individual Commands ╞═══════════════════
  110.  
  111.  Selected a Value  (   ):
  112.    When there are entries in the index list (Blk #, Start, & Stop) then one
  113.    of these entries is always "selected", as indicated by highlighting. The
  114.    highlight can be moved up and down with the vertical arrow keys. The
  115.    horizontal arrow keys select either the Start or Stop value. The selected
  116.    value can then be manipulated. Its numerical value can be changed with the
  117.    Shift key in combination with various cursor pad keys (see the following
  118.    commands). The selected block is also the target of the Play, Merge,
  119.    Split, Cut, Paste, Copy, and Delete commands.
  120.  
  121.  Selected Value + 1  (Shift+):
  122.    Adds 1 to the selected value unless it would cause an overlap.
  123.  
  124.  Selected Value + 100  (Shift+PgDn):
  125.    Adds 100 to the selected value unless it would cause an overlap.
  126.  
  127.  Selected Value + 10000  (Shift+End):
  128.    Adds 10000 to the selected value unless it would cause an overlap.
  129.  
  130.  Selected Value - 1  (Shift+):
  131.    Subtracts 1 from the selected value unless it would cause an overlap.
  132.  
  133.  Selected Value - 100  (Shift+PgUp):
  134.    Subtracts 100 from the selected value unless it would cause an overlap.
  135.  
  136.  Selected Value - 10000  (Shift+Home):
  137.    Subtracts 10000 from the selected value unless it would cause an overlap.
  138.  
  139.  Redraw Screen  (F9):
  140.    Redraws the entire screen. Intended primarily as a means of recovering
  141.    after screen is trashed by "Abort, Retry, Ignore, Fail?" message from DOS.
  142.  
  143.  Activate Menu  (F10):
  144.    Highlights the first selection in the menu bar. Use <Enter> key to show
  145.    pull-downs, select with arrow keys, then use <Enter> to perform the action
  146.    or <Esc> to back out.
  147.  
  148.  Load Index File  (Alt+I):
  149.    The cursor will appear in the "Index file" area (near the bottom of the
  150.    screen) allowing a file name to be entered and/or edited. Press <Enter>
  151.    to load the specified index file or <Esc> to do nothing.
  152.  
  153.  Load Data File  (Alt+D):
  154.    The cursor will appear in the "Data file" area (near the bottom of the
  155.    screen) allowing a file name to be entered and/or edited. Press <Enter>
  156.    to load the specified data file or <Esc> to do nothing.
  157.  
  158.  Change File Names  (Alt+N):
  159.    This allows the user to alter the current names of the index and data
  160.    files. Use the arrow keys to switch between file names. Press <Enter>
  161.    when done.
  162.  
  163.  Save Index File  (Ctrl+I):
  164.    The current index listing will be written to the file name shown at the
  165.    bottom of the screen as the "Index file". Use Alt+N to change this name.
  166.  
  167.  Save Data File  (Ctrl+D):
  168.    The current voice data will be written to the file name shown at the
  169.    bottom of the screen as the "Index file". Use Alt+N to change this name.
  170.  
  171.  Save Both  (Ctrl+S):
  172.    This combines the two save operations (see Save Index and Save Data).
  173.  
  174.  Create Index  (I):
  175.    This operation will analyze the entire data file, attempting to
  176.    distinguish between areas of sound and areas of silence. The areas of
  177.    sound will become blocks in the newly created index. The areas of silence
  178.    will become gaps in the index (i.e. parts of the data file that are not
  179.    included in any indexed block). NOTE: This will erase the current index
  180.    in memory (but not the one on disk, unless you then Save Index without
  181.    changing the file name). If a data file has already been stripped of its
  182.    silent areas by editing and the use of the Pack Data command, then Create
  183.    Index will not succeed because it will be unable to find areas of silence
  184.    in the file. Create Index is actually intended to be used only once on a
  185.    newly recorded data file.
  186.  
  187.  Pack Data  (Ctrl+P):
  188.    This will remove all areas of the data file which are not currently part
  189.    of any index entry. The indexed blocks will be packed together with no
  190.    addressing gaps. The index Start and Stop values will be adjusted
  191.    accordingly. This command is intended for use after careful editing to
  192.    strip out unused voice data and save disk space in the finished file.
  193.  
  194.  Help  (F1):
  195.    Displays this file.
  196.  
  197.  Exit  (Esc):
  198.    Exits to DOS from VDFE (after a last-chance prompt).
  199.  
  200.  Play the Block  (Enter):
  201.    The currently selected block is played through the speaker.
  202.  
  203.  Merge Current Block with Next  (M):
  204.    The currently selected block and the next sequential block will be
  205.    combined into a single block. The total block count will be decremented.
  206.  
  207.  Split Current Block  (S):
  208.    The currently selected block will be split into two blocks, each half the
  209.    size of the original. The total block count will be incremented.
  210.  
  211.  Cut Block to Clipboard  (Del):
  212.    The voice data of the currently selected block will be copied to the
  213.    clipboard (a temporary file), overwriting the previous clipboard contents.
  214.    The block will then be deleted from the voice data and index.
  215.  
  216.  Paste from Clipboard  (Insert):
  217.    This is the reverse of Cut to Clipboard. A new block will be created in
  218.    the index and data. The contents of the clipboard will then be copied into
  219.    this new block. The clipboard contents remain unchanged. NOTE: If the
  220.    currently selected value is a Start value, then the new block will be
  221.    inserted BEFORE it. If the currently selected value is a Stop value, then
  222.    the new block will be inserted AFTER it.
  223.  
  224.  Copy Block to Clipboard  (Shift+Insert):
  225.    The voice data of the currently selected block will be copied to the
  226.    clipboard (a temporary file), overwriting the previous clipboard contents.
  227.    The index and data will not be changed.
  228.  
  229.  Delete the Block  (Shift+Del):
  230.    The currently selected block will be deleted from the index and data. The
  231.    block count and data size will decrease.
  232.  
  233.  Write Clipboard to File  (W):
  234.    This will simply write the current clipboard voice data to a file. The
  235.    user will be prompted for a file name.
  236.  
  237.  Read File into Clipboard  (R):
  238.    This reads a user-specified voice data file into the clipboard,
  239.    overwriting the previous clipboard contents.
  240.  
  241.  Record into Clipboard  (F3):
  242.    The previous contents of the clipboard will be deleted, and recording will
  243.    start into the memory buffer. Once recording has terminated, either
  244.    through a keypress, the use of the "stop" switch on the digitizer board,
  245.    or running out of memory, the buffer will be copied into the clipboard.
  246.    NOTE: A common error consists of forgetting to set the COM port number
  247.    prior to recording.
  248.  
  249.  Play Clipboard Contents  (F4):
  250.    The current clipboard contents will be played through the speaker.
  251.  
  252.  Select COM Port  (F2):
  253.    This increments the digitizer COM port number, wrapping at 4.
  254.  
  255.  ═══════════════════════╡ A Typical Editing Session ╞════════════════════════
  256.  
  257.  Prepare a list of words, phrases, and sounds that you wish to record,
  258.  including the order in which they are to appear in the voice data file.
  259.  
  260.  If you have not already done so, read the section of the digitizer
  261.  documentation that concerns input volume levels and the indicator LEDs.
  262.  
  263.  Attach the digitizer to a COM port. Execute VDFE by typing its name at the
  264.  command prompt. You must not be running in a DOS box under Microsoft Windows
  265.  in enhanced mode. Press F2 repeatedly until the correct port number shows in
  266.  the "Digitizer port" box.
  267.  
  268.  If you are creating a new voice data file, press Alt+N and type both an
  269.  index file name and a data file name into the appropriate slots.
  270.  
  271.  To record new data: turn the digitizer on, then press F3 and start talking
  272.  (or whatever is appropriate). There is a delay of about one second between
  273.  the keypress and the start of data recording. VDFE will say "Go" at the
  274.  moment recording begins. Press a key on the keyboard or the "stop" switch on
  275.  the digitizer when finished. You can listen to the recording just made by
  276.  pressing F4. If the recording is not satisfactory, re-record it by pressing
  277.  F3.
  278.  
  279.  Once the recording in the clipboard is considered satisfactory, it may be
  280.  inserted into the main data file by pressing Insert. If more data must be
  281.  recorded than will fit into the memory buffer, then repeat the previous
  282.  procedure until all desired sounds have been accumulated as blocks in the
  283.  data file. Be sure that you have enough free disk space before starting.
  284.  Remember also to turn off the digitizer when not in use to conserve the
  285.  batteries.
  286.  
  287.  If you want to use the automatic indexing capability, press the "I" key at
  288.  this point and a new index will be created.
  289.  
  290.  Use the Selected Value increment and decrement commands to adjust the
  291.  position and size of each block as required. Some sounds intended as one
  292.  block will probably appear as several, due to embedded silence. Use the
  293.  Merge command to combine them. As you adjust each block, use the Enter key
  294.  to listen to it in its current state.
  295.  
  296.  Once all blocks are correct, and you are sure that the data in the
  297.  inter-block gaps is not needed, press Ctrl+P to remove the unneeded data and
  298.  minimize the file size. Press Ctrl+S to save the index and data files.
  299.  
  300.  *   *   *   *   *   *   *     End of Help File     *   *   *   *   *   *   *
  301.